file-truename doc fix for bug#2341.

* lisp/files.el (file-truename): Doc fix.

* doc/lispref/files.texi (Truenames): Minor clarification.

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index e8eea3c6bf3337c6e8290bc50138fb87b31e99ad..0ecf253e6f2bb754eed2a56e005662bd908e24d9 100644 (file)
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,7 @@
+2011-03-03  Glenn Morris  <rgm@gnu.org>
+
+       * files.texi (Truenames): Minor clarification.  (Bug#2341)
+
 2011-03-01  Glenn Morris  <rgm@gnu.org>
 
        * variables.texi (Directory Local Variables):

diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi
index 3697f18baddac3959ffbc301c3b33f56b761ee76..e3bdebd28a1cc8097710e80dc24d21b42e563930 100644 (file)
--- a/doc/lispref/files.texi
+++ b/doc/lispref/files.texi
@@ -1041,7 +1041,8 @@ because they eliminate symbolic links as a cause of name variation.
 
 @defun file-truename filename
 The function @code{file-truename} returns the truename of the file
-@var{filename}.  The argument must be an absolute file name.
+@var{filename}.  If the argument is not an absolute file name,
+this function first expands it against @code{default-directory}.
 
 This function does not expand environment variables.  Only
 @code{substitute-in-file-name} does that.  @xref{Definition of

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 9ec9c00c90d47b71048989e0adbbb606a9273f00..09044dfc6449bff86e85bff43671f81e194f0120 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,7 @@
+2011-03-03  Glenn Morris  <rgm@gnu.org>
+
+       * files.el (file-truename): Doc fix.  (Bug#2341)
+
 2011-03-03  Bob Rogers  <rogers-emacs@rgrjr.dyndns.org>
 
        * vc/vc-dir.el (vc-dir-mode-map): Bind vc-dir-find-file to e. (Bug#7349)

diff --git a/lisp/files.el b/lisp/files.el
index 8849e26415119fd4cc59139604534bf552dc921c..a8f937233de928ccb87d5ae5a21ef706aab21680 100644 (file)
--- a/lisp/files.el
+++ b/lisp/files.el
@@ -983,7 +983,8 @@ accessible."
       nil)))
 
 (defun file-truename (filename &optional counter prev-dirs)
-  "Return the truename of FILENAME, which should be absolute.
+  "Return the truename of FILENAME.
+If FILENAME is not absolute, first expands it against `default-directory'.
 The truename of a file name is found by chasing symbolic links
 both at the level of the file and at the level of the directories
 containing it, until no links are left at any level.